Skip to content

docs: add Develop AI agents on Apify page#2375

Open
marcel-rbro wants to merge 5 commits intomasterfrom
docs/develop-ai-agents-page
Open

docs: add Develop AI agents on Apify page#2375
marcel-rbro wants to merge 5 commits intomasterfrom
docs/develop-ai-agents-page

Conversation

@marcel-rbro
Copy link
Copy Markdown
Contributor

@marcel-rbro marcel-rbro commented Mar 27, 2026

Summary

  • New page "Develop AI agents on Apify" at /actors/development/quick-start/develop-ai-agents covering the full AI agent development stack: AI templates, AI Sandbox, OpenRouter LLM access, pay-per-event monetization, and deployment
  • Cross-link added from existing "Build with AI" page to the new page
  • Distinct from "Build with AI" (which covers using AI coding assistants) — this page is about building AI agent products that run on Apify

Open questions

  • Token usage tracking: How to extract token counts from OpenRouter responses for PPE per-token charging (flagged with a caution admonition in the draft)
  • AI Sandbox details: Content based on Actor README + Dusan's brainstorm — needs review from the sandbox team
  • OpenRouter: First standalone explanation in docs — verify accuracy with the team

Test plan

  • Preview build renders the page correctly
  • Sidebar shows "Develop AI agents" after "Build with AI"
  • All internal and external links work
  • Linting passes (npm run lint:md ✅)

🤖 Generated with Claude Code

@marcel-rbro @claude
docs: add "Develop AI agents on Apify" page
81fa245 
New page covering the full AI agent development stack on Apify:
templates, AI Sandbox, OpenRouter LLM access, PPE monetization,
and deployment. Cross-links from existing "Build with AI" page.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@github-actions github-actions bot added the t-docs Issues owned by technical writing team. label Mar 27, 2026
@marcel-rbro @claude
fix: use /platform prefix for internal doc links
5cf0324 
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@apify-service-account
Copy link
Copy Markdown

apify-service-account commented Mar 27, 2026

Preview for this PR was built for commit 5cf0324 and is ready at https://pr-2375.preview.docs.apify.com!

@apify-service-account
Copy link
Copy Markdown

apify-service-account commented Mar 27, 2026

Preview for this PR was built for commit b5e15e5 and is ready at https://pr-2375.preview.docs.apify.com!

MQ37
MQ37 reviewed Mar 30, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

@MQ37 MQ37 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Quickly went through it and looks good, only two comments 👍

@jirispilka jirispilka self-requested a review March 31, 2026 06:55
jirispilka
jirispilka requested changes Mar 31, 2026
View reviewed changes
Copy link
Copy Markdown
Contributor

@jirispilka jirispilka left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I believe this is an initial version that we plan to expand later on?

It would clearly deserve a bit more explanations and context.

sources/platform/actors/development/quick-start/develop_ai_agents.md Outdated
slug: /actors/development/quick-start/develop-ai-agents
---

The Apify platform provides everything you need to build, test, and deploy AI agents. This page walks you through the full stack: templates, sandbox code execution, LLM access through OpenRouter, pay-per-event monetization, and deployment to [Apify Store](https://apify.com/store).
Copy link
Copy Markdown
Contributor

@jirispilka jirispilka Mar 31, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

An image that would connect all these things together would be nice. It would guide me through the docs page easily. Otherwise it is a bit difficult to connect the dots. For example, you don't need sandbox at all, so you should give people an idea where they can use it

@apify-service-account
Copy link
Copy Markdown

apify-service-account commented Apr 1, 2026

Preview for this PR was built for commit 29c6b461 and is ready at https://pr-2375.preview.docs.apify.com!

@apify-service-account
Copy link
Copy Markdown

apify-service-account commented Apr 2, 2026

Preview for this PR was built for commit e4b2b453 and is ready at https://pr-2375.preview.docs.apify.com!

@vystrcild
Copy link
Copy Markdown
Contributor

vystrcild commented Apr 14, 2026

Sorry, guys - I didn't realize you put your comments here :(
I see @marcel-rbro already fix those - so could we release this first version and then iterate if necessary?

@marcel-rbro marcel-rbro requested a review from jirispilka April 14, 2026 11:31
@marcel-rbro marcel-rbro marked this pull request as ready for review April 14, 2026 11:32
@marcel-rbro marcel-rbro requested a review from TC-MO as a code owner April 14, 2026 11:32
@marcel-rbro
Copy link
Copy Markdown
Contributor Author

marcel-rbro commented Apr 14, 2026

I have the note that I need to create the diagram and add more details in my backlog, but it's true that there's no need to block this task. @jirispilka @TC-MO final review please so we can ship this?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Reviewers

@MQ37 MQ37 MQ37 left review comments

@jirispilka jirispilka Awaiting requested review from jirispilka

@TC-MO TC-MO Awaiting requested review from TC-MO TC-MO is a code owner

Requested changes must be addressed to merge this pull request.

Assignees

@marcel-rbro marcel-rbro

Labels

t-docs Issues owned by technical writing team.

Projects

None yet

Milestone

No milestone

Development

Successfully merging this pull request may close these issues.

5 participants

@marcel-rbro @apify-service-account @vystrcild @jirispilka @MQ37